Settingsinterface
Properties (26)
| Property | Type | Default | Required | Description |
|---|---|---|---|---|
| addHardwareDataToAttributes⚓︎ | boolean | false | x | In io.Connect Desktop: if |
| additionalAttributes⚓︎ | { [x: string]: unknown } | (() => { [x: string]: unknown }) | x | x | Additional properties to publish as part of each OpenTelemetry signal, specified as key/value pairs. You can use environment variables as values. Environment variables must start and end with a percent sign (e.g., |
| additionalResourceAttributes⚓︎ | { [x: string]: unknown } | (() => { [x: string]: unknown }) | x | x | Additional properties to publish as part of the OpenTelemetry resource definition for all OpenTelemetry signals, specified as key/value pairs. You can use environment variables as values. Environment variables must start and end with a percent sign (e.g., |
| addResourceAttributesToAttributes⚓︎ | boolean | false | x | Whether to add resource attributes to signal attributes. |
| applicationName⚓︎ | string | x | x | Application name to use in telemetry information. By default, it's populated by io.Connect. |
| enabled⚓︎ | boolean | x | Whether library is enabled. If disabled, API is still usable, but methods are no-ops. |
|
| errorlessMode⚓︎ | boolean | false | x | If |
| failOnInitError⚓︎ | boolean | x | x | If failure to initialize library will throw upstream error. |
| finalExportTimeoutMs⚓︎ | number | 0 | x | Interval in milliseconds to wait for any remaining telemetry data to be exported during shutdown of the platform. This is the maximum awaiting interval and the platform may shutdown before it expires if all telemetry data has already been published. If |
| headers⚓︎ | { [x: string]: string } | (() => { [x: string]: string }) | x | x | Additional headers to send in HTTP requests, e.g. when using HTTP exporters. |
| lastChanceExportOnError⚓︎ | boolean | LastChanceExportOnErrorSettings | true | x | In io.Connect Desktop, gets the telemetry describing an abnormal exit out before the
platform exits: a startup error, an unhandled error (crash) at any later point, an exit
with an error code, or a shutdown before the startup has completed (restarts excluded).
The final export waits for up to LastChanceExportOnErrorSettings.exportTimeoutMs instead
of
|
| lateInit⚓︎ | boolean | LateInitSettings | false | x | In io.Connect Desktop, initializes io.Insights late in the startup - right after the SSO authentication has completed (see LateInitSettings.initStage) - rather than as early as possible. The startup telemetry gathered until then is buffered and published once io.Insights is initialized. Early initialization makes the startup trace richer and helps telemetry be published even
in the case of an early startup error; a late one lets a "pre-sso" autoStart application
provide additional OTEL attributes at runtime before io.Insights gets initialized (see
LateInitSettings.attributesTimeoutMs), and lets the platform's own export requests carry
the SSO login from the first one on (see
|
| logs⚓︎ | LogsSettings | x | x | x |
| logSettingsOnStartup⚓︎ | boolean | true | x | If the library should log the settings used to initialize it. |
| metrics⚓︎ | MetricsSettings | x | x | x |
| platformVersion⚓︎ | string | x | x | If provided, this value will be added to the metrics and span attributes and to the span filtering context (see 'filters' in TracesSettings). |
| registerGlobalOTELObjects⚓︎ | boolean | "force" | true | x | Whether the library should register its own instances of the OTEL SDK global objects, e.g. MeterProvider. This is useful for controlling which instance of the SDK is used, in applications that initialize their own SDK. If If If |
| requestSettings⚓︎ | boolean | true | x | For Node applications: whether to attempt to request io.Insights settings from the platform when initializing; |
| serviceId⚓︎ | string | x | x | If provided, this value will be added to the metrics and traces service.instance.id attribute, unless an OTEL service object (e.g. TraceProvider) has been provided to the library with a different setting. |
| serviceName⚓︎ | string | x | x | If provided, this value will be added to the metrics and traces service.name attribute, unless an OTEL service object (e.g. TraceProvider) has been provided to the library with a different setting. |
| serviceVersion⚓︎ | string | x | x | If provided, this value will be added to the metrics and traces service.version attribute, unless an OTEL service object (e.g. TraceProvider) has been provided to the library with a different setting. attribute. |
| ssoAuth⚓︎ | SSOAuthSettings | x | x | Settings for injecting the io.Connect SSO login information into the headers of the OpenTelemetry export requests. Can be overridden for the traces, the metrics and the logs in their own settings. See SSOAuthSettings. |
| suppressDoubleInitializationWarnings⚓︎ | boolean | false | x | Suppress double initialization warnings from the OTEL SDK. |
| traces⚓︎ | TracesSettings | x | x | x |
| useExistingOTELSDK⚓︎ | boolean | false | x | If Ordering matters: the trace and logs globals are proxies that late-bind, so signals emitted before the host registers its SDK are dropped and start flowing once it does; the metrics global is a snapshot, which io.Insights compensates for by re-resolving it per meter creation - but meters created before the host registered stay bound to the noop. Register the host SDK before initializing io.Insights for full coverage. In this mode io.Insights registers nothing: registerGlobalOTELObjects is effectively ignored, the global propagator is whatever the host registered (header injection rides it), resource attributes come from the host's providers (io.Insights resource settings are unused), and waitForFinalExport is best-effort - flushing on shutdown is the host SDK's responsibility. |
| userId⚓︎ | string | x | x | If provided, this value will be added to the metrics and traces user.id attribute, unless an OTEL service object (e.g. TraceProvider) has been provided to the library with a different setting. |